Skip to content

docs(tests): lock run summary/index/sidecar boundary contract - #1700

Merged
christso merged 1 commit into
mainfrom
cpl5-docs
Jul 6, 2026
Merged

docs(tests): lock run summary/index/sidecar boundary contract#1700
christso merged 1 commit into
mainfrom
cpl5-docs

Conversation

@christso

@christso christso commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Rewrites apps/web/src/content/docs/docs/next/reference/result-artifacts.mdx to match the shipped av-cpl5.2/#1697 (cases[] -> tests[], counts rename, metadata.run_id dedup) and av-cpl5.3/#1699 (target_execution/transcript_summary moved off .internal/index.jsonl rows behind a compact target_error_kind) shapes: new "Summary Contract" section with a worked summary.json example, slimmed row example, and explicit summary = run aggregate / index.jsonl = dashboard-ready row manifest / sidecars = detailed evidence framing.
  • Fixes a stale metadata.run_id reference in wip-checkpoints.mdx (the field moved to the summary root).
  • Amends ADRs 0011, 0012, and 0017 with the new boundary and records projection_identity staying inline as a permanent design decision (not a follow-up TODO), with the duplicate-policy read-back rationale.
  • Adds packages/core/test/evaluation/run-artifacts-contract.test.ts, a fixture-based regression test that fails if cases/total_cases/passed_cases/failed_cases/total_instances/errored_instances/metadata.run_id/target_execution/transcript_summary/verdict reappear as public canonical fields on summary.json or .internal/index.jsonl rows.

Implements av-cpl5.4 (docs + regression fixtures only, no code changes). Parent tracker: av-cpl5.

Test plan

  • bun test packages/core/test/evaluation/run-artifacts-contract.test.ts — 3 pass
  • bun test packages/core/test/evaluation/ — 2256 pass (full focused suite, no regressions)
  • bun --filter @agentv/core typecheck — pass
  • bunx biome check packages/core/test/evaluation/run-artifacts-contract.test.ts — clean
  • Manually verified new relative markdown links in docs/adr/0017-*.md resolve on disk (repo's CI Check Links job runs lychee on **/*.md, offline; lychee isn't installed locally to run directly)

🤖 Generated with Claude Code

Rewrites the result artifact contract doc and ADRs 0011/0012/0017 to match
the shipped av-cpl5.2 (cases[] -> tests[], counts rename, metadata.run_id
dedup) and av-cpl5.3 (target_execution/transcript_summary moved off index
rows behind a compact target_error_kind) shapes, fixes a stale
metadata.run_id reference in wip-checkpoints.mdx, and records why
projection_identity stays inline as a permanent design decision. Adds a
fixture-based regression test that fails if the retired cases/instances/
target_execution/transcript_summary/verdict fields reappear as public
canonical fields.

av-cpl5.4

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: 230a8a4
Status: ✅  Deploy successful!
Preview URL: https://a652146b.agentv.pages.dev
Branch Preview URL: https://cpl5-docs.agentv.pages.dev

View logs

@christso
christso merged commit 09275d8 into main Jul 6, 2026
8 checks passed
@christso
christso deleted the cpl5-docs branch July 6, 2026 09:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant